home *** CD-ROM | disk | FTP | other *** search
/ Power Utilities / Power Utilities.iso / utility / pro94 / xprt.txt < prev   
Encoding:
Text File  |  1993-07-31  |  11.8 KB  |  324 lines
  1.                                  XPRT
  2.  
  3. XPRT formats text for output to the HP LaserJet Family, and compatible
  4. laser printers. Some of XPRT's features are:
  5.  
  6. 1.  Graybar toggle - Provides shading of alternating lines of text to
  7.     help delineate lines of source code.
  8.  
  9. 2.  Smart word wrap - Will wrap at a whitespace if possible. Maintains
  10.     text indentation (source code structure).
  11.  
  12. 3.  Port Selection - Allow selection of LPT1, LPT2, LPT3, or a file
  13.     for output. If file is chosen, it can later be typed or copied to
  14.     the printer.
  15.  
  16. 4.  Miniature Type - Allows combining subscript, superscript, and
  17.     compressed print. This lets you cram lots more on a page.
  18.  
  19. 5.  Menu or Command Line - Command line operation allows XPRT to be
  20.     called from another program for hands-off operation.
  21.  
  22. 6.  Page heading that includes file name, date, and page number. An
  23.     alternate heading also provides the FILE date and time. Page
  24.     headings may also be turned off.
  25.  
  26. 7.  The current configuration of XPRT may be saved as the default.
  27.     Selecting 'S' from the menu establishes new default settings.
  28.  
  29.     ------------------------------------------------------------------
  30.                                    Note
  31.     vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
  32.     
  33.     For use on a Local Area Network... if XPRT.EXE is write-protected
  34.     for any reason, XPRT.CFG will be created in the current directory.
  35.     When XPRT starts, it will attempt to open XPRT.CFG for default
  36.     setup information. If the .CFG file cannot be opened, XRPT will
  37.     use it's internal setup data.
  38.  
  39.     If XPRT.EXE is not write-protected, the setup data will be saved 
  40.     to the executable file. XPRT.CFG will not be created.
  41.  
  42.     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  43.     ------------------------------------------------------------------
  44.  
  45. 8.  If the resulting printout is 10 pages or more, XPRT will beep
  46.     upon completion. This is to prevent you from having to watch
  47.     the monitor for long periods of time.
  48.  
  49. 9.  Support for legal size paper.
  50.  
  51. 10. Once registered, one need only download later versions to upgrade.
  52.     There is no charge for upgrades unless mailing a disk is required.
  53.     This will cost $10.00.
  54.    
  55. 11. Support for using other printer utilities prior to XPRT.
  56.  
  57. XPRT will check for a printer connected to the port if an LPT is 
  58. selected. It cannot, however, determine it the printer is LaserJet
  59. compatible. It must assume that the operator knows. This is
  60. unavoidable as the LaserJet provides no means of identification
  61. via software.
  62.  
  63. Oh-by-the-way... The LaserJet II does not provide ELITE type without
  64. one of several font cartridges. If ELITE is selected but not
  65. available, the printer will default to COMPRESSED print. This does
  66. not apply to the LaserJet III.
  67.  
  68. If you experience problems viewing XPRT with a monochrome monitor,
  69. set an environment variable MONITOR equal to MONO in your autoexec.bat
  70. file.
  71.    i.e.    set MONITOR=MONO
  72.  
  73. Command line switches can all be jammed together or separated by 
  74. whitespace.
  75.  
  76.   Syntax: XPRT [filename] [switches]
  77.  
  78.    Where: filename = Name of text file to be printed, path included.
  79.           switches = Optional formatting switches (see below).
  80.  
  81.   Command line switches:
  82.  
  83.   A    = Compressed print.
  84.   B    = Elite print (if supported.)
  85.   C    = Pica print.
  86.   D    = Miniature print.
  87.   L    = Landscape (letter size.)
  88.   M    = Landscape (legal size.)
  89.   Q    = Portrait (letter size.)
  90.   V    = Portrait (legal size.)
  91.   F    = Respond to embedded formfeed character.
  92.   Y    = Ignore embedded formfeed character.
  93.   R    = Do not reset printer prior to printing.
  94.   Gnnn = Shade alternating lines of text.
  95.          Where nnn is the width of the shading.
  96.  
  97.          The command line:
  98.  
  99.             XPRT somefile.txt G3 
  100.  
  101.          Will shade alternating sets of three lines.
  102.  
  103.             XPRT somefile.txt G100
  104.  
  105.          Will shade the entire page.
  106.  
  107.   Hn   = Page heading select.
  108.          If n is 0 - No heading is printed.
  109.          If n is 1 - The heading contains the file name, page number,
  110.                      and the current date/time.
  111.          If n is 2 - The file date/time is added to the heading also.
  112.  
  113.   Inn  = Indent left margin nn spaces. Max is 25.
  114.   Tnn  = Expand tabs to nn spaces. Max is 25.
  115.   Pn   = Printer port selection.
  116.          If n is 1 - Print to LPT1
  117.          If n is 2 - Print to LPT2
  118.          If n is 3 - Print to LPT3
  119.          If n is 4 - Print to FILE
  120.  
  121.          The command line:
  122.  
  123.              XPRT somefile.txt p4
  124.  
  125.          Will produce an output file named 'filename.XPR' in the current
  126.          directory. If this file already exists, it will be overwritten
  127.          without warning.
  128.  
  129. XPRT /r  will allow the user to enter the serial number that is assigned
  130.          upon registration.
  131.          
  132. XPRT /?  will display a list of command line switches for batch mode.
  133.  
  134. Initial Defaults: Pica, Portrait, Embedded formfeed on, Gray Bar Off,
  135. Page Header One, Indent 5, Port LPT1, 4 Spaces/Tab, Reset On.
  136.  
  137. Typing XPRT with a [filename] will bring up the XPRT options menu.
  138.  
  139. Typing XPRT with a [filename] and [switches] will go directly to 
  140. printing.
  141.  
  142. The author may be reached via:
  143.  
  144.       Mail - Paul R. Bearden
  145.              North Texas Computer Solutions
  146.              Box 426 / 312 N. Illinois Street
  147.              Celina, TX     75009
  148.  
  149.      Phone - (214) 382-2867
  150.  
  151. Compuserve - 72117, 510.
  152. Internet   - 72117.510@compuserve.com
  153.  
  154.  /*****************************************************\
  155.  * This is for Polytron Version Control System 
  156.  *
  157.  * $Author:   Paul R. Bearden  $
  158.  * $Logfile:   E:/xprt_dos/xprt.c_v  $
  159.  * $Revision:   4.6  $
  160.  * $Date:   29 Jul 1993 19:35:58  $
  161.  *
  162.  * $Log:   E:/xprt_dos/xprt.c_v  $
  163.  * 
  164.  *    Rev 4.6   29 Jul 1993 19:35:58   Paul R. Bearden
  165.  * Fixed a problem with command line operation. XPRT was losing the
  166.  * name of the file to print under some circumstances.
  167.  * 
  168.  *    Rev 4.5   25 Jul 1993 06:53:28   Paul R. Bearden
  169.  * 1. Open file to print in read-only mode. Opening in 'r+' causes
  170.  *    problems in OS/2.
  171.  * 2. Fixed one help screen problem.
  172.  * 3. Fixed another wordwrap problem. Was not taking indent into
  173.  *    account when wrapping.
  174.  * 4. Changed SaveDefaults () to keep the original XPRT.EXE date
  175.  *    and time.
  176.  * 
  177.  *    Rev 4.4   21 Mar 1993 18:00:46   unknown
  178.  * 1. Added 'New' file selection capability.
  179.  * 2. Added 'Reset' toggle to prevent reset prior to print. This is to
  180.  *    allow a printer setup utility to run before XPRT.
  181.  * 3. Changed type selection to [A] toggle.
  182.  * 4. Changed 'About...' to 'Help...'.
  183.  * 5. Updated 'Help' screens.
  184.  * 
  185.  *    Rev 4.3   19 Jul 1992 10:58:48   Paul R. Bearden
  186.  * Fixed word wrap bug by removing 'ungetch'.
  187.  * 
  188.  *    Rev 4.2   24 Jun 1992 05:56:42   Paul R. Bearden
  189.  * Correction to cpi in 'About' screens.
  190.  * 
  191.  *    Rev 4.1   16 Jun 1992 05:35:34   Paul R. Bearden
  192.  * Changed 'Compressed Print' from 6 lpi to 7 lpi.
  193.  * 
  194.  *    Rev 4.0   14 May 1992 08:02:54   Paul R. Bearden
  195.  * Added room for a few more characters/line in landscape-legal.
  196.  * 
  197.  *    Rev 3.9   25 Mar 1992 09:23:40   Paul R. Bearden
  198.  * Fixed graybar problem... was not printing last graybar on the page.
  199.  * 
  200.  *    Rev 3.8   25 Feb 1992 11:34:20   Paul R. Bearden
  201.  * 1. Changed default screen, 'S' is NOT a command line switch.
  202.  * 2. Converted back to Microsoft C 6.0... The QEMM errors stopped
  203.  *    when I stopped using Borland C++ 3.0.
  204.  * 
  205.  *    Rev 3.7b  16 Feb 1992 16:28:26   Paul R. Bearden
  206.  * Fixed problem of crashing under QEMM.
  207.  *
  208.  *    Rev 3.7a  08 Feb 1992 07:07:22   Paul R. Bearden
  209.  * Fixed Imbedded Form Feed Toggle.
  210.  *
  211.  *    Rev 3.7   05 Feb 1992 08:22:12   Paul R. Bearden
  212.  * 1. Changed 'Elite' print to 7 lpi.
  213.  * 2. Added support for legal size paper.
  214.  * 3. Improved LAN support with XPRT.CFG file. If write access is
  215.  *    denied to XPRT.EXE, the configuration information will be
  216.  *    saved to XPRT.CFG in the current directory.
  217.  * 
  218.  *    Rev 3.6   13 Dec 1991 17:26:14   Paul R. Bearden
  219.  * 1. Fixed bugs in command line interface.
  220.  * 2. Added registration instructions to default screen.
  221.  * 3. Fixed 'special keys' in EscPressed ().
  222.  * 4. Changed GoRegister () to delete registration number if an
  223.  *    invalid number is entered.
  224.  * 
  225.  *    Rev 3.5   26 Nov 1991 14:32:18   PBEARDEN
  226.  * 1. Moved registration information to the last 'About' screen.
  227.  * 2. Removed the need for FINDIT.EXE
  228.  * 3. Fixed a minor bug in 'Header Two'.
  229.  * 
  230.  *    Rev 3.4   21 Nov 1991 15:34:46   PBEARDEN
  231.  * 1. More mouse support.
  232.  * 2. Added option for different page headings.
  233.  * 3. Added option to select number of grayed lines.
  234.  * 4. Allow user to enter registration number.
  235.  * 
  236.  *    Rev 3.3   21 Oct 1991 15:13:48   PBEARDEN
  237.  * Added mouse support to 'About' screens.
  238.  * 
  239.  *    Rev 3.2   21 Oct 1991  8:50:08   PBEARDEN
  240.  * Added a registration price list to the 'About' screens.
  241.  * 
  242.  *    Rev 3.1   11 Oct 1991  6:56:56   PBEARDEN
  243.  * Removed reference to legal size paper in the help screens.
  244.  * 
  245.  *    Rev 3.0   27 Aug 1991 10:07:18   PBEARDEN
  246.  * 1. Added 'Save Setup' selection.
  247.  * 2. Minor tweaks to embedded page break handling code.
  248.  * 3. Beep when finished printing (if 10 pages or more.)
  249.  * 4. Print correct number of lines when printing w/o headers.
  250.  * 5. Add more 'About' screens. Added 'ESC' to break out of them.
  251.  * 6. Changed default 'Print to' file for batch printing.
  252.  * 
  253.  *    Rev 2.9   12 Aug 1991 19:00:50   PBEARDEN
  254.  * Added 'About...' selection to menu.
  255.  * 
  256.  *    Rev 2.8   08 Aug 1991 14:03:32   PBEARDEN
  257.  * Minor tweaks.
  258.  * 
  259.  *    Rev 2.7   31 Jul 1991 13:12:12   PBEARDEN
  260.  * 1. Don't send a formfeed if it is on the first line of a page.
  261.  * 2. Minor fix to wordwrap.
  262.  * 
  263.  *    Rev 2.6   29 Jul 1991  9:57:38   PBEARDEN
  264.  * Fixed some uninitialized variables that PC-Lint found.
  265.  * 
  266.  *    Rev 2.5   11 Jul 1991 17:42:28   PBEARDEN
  267.  * Command line (batch) operation will now exit after printing without
  268.  * displaying the copyright message or waiting for a keypress.
  269.  * 
  270.  *    Rev 2.4   04 Jul 1991 10:04:24   PBEARDEN
  271.  * Fixed a bug in the command line Header Toggle.
  272.  * 
  273.  *    Rev 2.3   04 Jul 1991  9:25:58   PBEARDEN
  274.  * Changed default Spaces/Tab from 5 to 4.
  275.  * 
  276.  *    Rev 2.2   02 Jul 1991 13:04:38   PBEARDEN
  277.  * 1. Added page header toggle.
  278.  * 2. Added space/tab selection.
  279.  * 
  280.  *    Rev 2.1   29 Jun 1991 18:42:32   PBEARDEN
  281.  * 1. Removed lots of redundant code.
  282.  * 2. Renamed CountLines () to CountPages ().
  283.  * 3. Added GetLine ().
  284.  * 4. Removed path from the filename in the page heading.
  285.  * 
  286.  *    Rev 2.0   19 Jun 1991 13:48:08   PBEARDEN
  287.  * 1. Display name of file to print at top of menu.
  288.  * 2. Provide means for entering a file name for Print-to-File.
  289.  * 3. Warn if Print-to-File file name already exists.
  290.  * 4. Don't display copyright message on registered copies.
  291.  * 
  292.  *    Rev 1.8   14 Jun 1991  6:46:30   PBEARDEN
  293.  * A few minor tweaks.
  294.  * 
  295.  *    Rev 1.7   13 Jun 1991 16:59:52   PBEARDEN
  296.  * Fixed a bug in the embedded page break handling.
  297.  * Added 'Printing page ...' message.
  298.  * 
  299.  *    Rev 1.6   12 Jun 1991 18:10:26   PBEARDEN
  300.  * Broke into several logical functions... finally.
  301.  * 
  302.  *    Rev 1.5   05 Jun 1991 13:23:18   PBEARDEN
  303.  * Squashed a few bugs in the blank line handling stuff.
  304.  * 
  305.  *    Rev 1.4   04 Jun 1991 18:59:48   PBEARDEN
  306.  * Throw away (don't print) blank lines at the end of a file.
  307.  * 
  308.  *    Rev 1.3   28 May 1991 13:37:06   PBEARDEN
  309.  * Added default instructions.
  310.  * Improved batch mode (command line switches).
  311.  * Allow 2 digit indent value.
  312.  * 
  313.  *    Rev 1.2   24 May 1991 11:48:54   PBEARDEN
  314.  * Added printer toggle for LPT1, LPT2, and LPT3.
  315.  * 
  316.  *    Rev 1.1   20 May 1991 13:22:54   PBEARDEN
  317.  * Fixed push/pop problem. Not enough pops.
  318.  * 
  319.  *    Rev 1.0   01 Mar 1991  8:59:56   PBEARDEN
  320.  * Initial revision.
  321.  * 
  322.  \*****************************************************/
  323.  
  324.